home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 020a / cshw824b.zip / CSHOW8B.DOC < prev    next >
Text File  |  1991-05-07  |  21KB  |  532 lines
  1.                                =================
  2.                                C o m p u S h o w
  3.                                =================
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                             Enhanced Version 8.24b
  10.  
  11.                                     for the
  12.                  IBM PC, XT, AT, PCjr, PS/2 (and compatibles)
  13.                                      with
  14.  
  15.                      Hercules Monochrome Graphics Adapter
  16.                                       or
  17.                          Color Graphics Adapter (CGA)
  18.                                       or
  19.                         Enhanced Graphics Adapter (EGA)
  20.                                       or
  21.                        Multi-Color Graphics Array (MCGA)
  22.                                       or
  23.                           Video Graphics Array (VGA)
  24.  
  25.  
  26.                                       and
  27.                                Graphics Printer
  28.  
  29.  
  30.  This documentation describing features of the enhanced CompuShow program is a
  31.  supplement to the standard program documentation, CSHOW8A.DOC.
  32.  
  33. The System Configuration Program
  34. ================================
  35.  
  36.  The System Configuration  Program is  used to install  screen colors,  select
  37.  video and printer drivers, and set start-up options. At your DOS prompt, type
  38.  CSHOWI and  a <carriage  return>.  (On a  Leading Edge  you  may need  to  do
  39.  "CSHOWI #L".)
  40.  
  41. Screen Colors
  42. -------------
  43.  
  44.  There are nine color settings, in four areas:
  45.  
  46.   - SCREEN TOP colors are used for the  top three lines of the screen and  for
  47.     pop-up boxes.  You specify  a background  color, normal  and hilight  text
  48.     colors.
  49.  
  50.   - SCREEN CENTER colors  are used  in the center  of the  screen. Again,  you
  51.     specify the background color, normal and hilight text colors.
  52.  
  53.   - INPUT FIELD colors are used in the input area, and for the "highlight bar"
  54.     that you move through the directory list.
  55.  
  56.  
  57.  
  58.  
  59.                                                                         Page 1
  60.   - BORDER COLOR is  the color  of the screen  border. (Hercules,  EGA, and  a
  61.     number of CGA  adapter/monitor combinations  WILL NOT  display the  border
  62.     color. "Standard CGA"  or VGA systems  will. The Leading  Edge #L  command
  63.     line switch disables the border color.)
  64.  
  65.  In the lower  half of  the screen, all  combinations of  background and  text
  66.  colors are displayed. Background colors are identified with the numbers 0..7,
  67.  and text colors with the letters A..P.
  68.  
  69.  You make your selection for  each of the nine colors  in the top half of  the
  70.  screen. At each of the nine specifications:
  71.  
  72.   - Press carriage return to  leave the color unchanged  and move to the  next
  73.     field.
  74.  
  75.   - Enter the letter or number of the color and press carriage return to  move
  76.     ahead. As you change any color, the screen is updated immediately.
  77.  
  78.   - Press TAB to move back to the previous color specification.
  79.  
  80.   - Press ESCape to exit the color install, ABANDONING any changes.
  81.       (You must complete the configuration  program to save changes to  screen
  82.       colors and other options. The only exception is that drivers are written
  83.       to disk as soon as you make a selection.)
  84.  
  85. Video Drivers
  86. -------------
  87.  
  88.  The next screen lets you select a video  driver. Press [F1] to "peek" at  the
  89.  section of video RAM  which normally contains  the manufacturer's name.  This
  90.  may help you determine which driver you need for a "Super-VGA".
  91.  
  92.   - All available drivers  are listed. The  "current driver" is  shown at  the
  93.     bottom of the  screen. If you  have a  driver from a  previous version  of
  94.     CompuShow, it's  identified as  "WRONG DRIVER  VERSION", and  you need  to
  95.     select a driver listed on the screen.
  96.  
  97.   - Type the number of the driver and <carriage return>.
  98.  
  99.      - The program  tests each  video  driver mode  by displaying  a  graphics
  100.        screen with  arrows extending  top  to bottom  and  left to  right  and
  101.        sixteen color bars (counting black).
  102.  
  103.      - After each  mode is  tested, respond  "Y" or  "N" to  tell the  program
  104.        whether the mode works correctly on your adapter.
  105.  
  106.      - After all modes have  been tested, if you  indicated that at least  one
  107.        mode worked, the program asks if  you want this driver. If you  respond
  108.        "Y", the program writes file  VIDEO.DAT to indicate which driver  modes
  109.        work, as well as VIDEO.DRV, the selected video driver.
  110.  
  111.   - The current driver  name reflects  the driver you've  selected. (Once  you
  112.     have the driver you want,  you don't need to select  it each time you  run
  113.     CSHOWI.)
  114.  
  115.   - Press <carriage return> to move on to the next screen.
  116.  
  117.  
  118.                                                                         Page 2
  119. Printer Drivers
  120. ---------------
  121.  
  122.  The next screen  allows you  to select a  printer driver,  and parallels  the
  123.  video driver  selection, although  no test  is performed.  After selecting  a
  124.  printer driver, indicate whether your printer  is attached to LPT1, LPT2,  or
  125.  LPT3 (if you don't know for sure, LPT1 is "normal".)
  126.  
  127. Start-Up Options
  128. ----------------
  129.  
  130.  The next screen allows you  to set a number of  start-up options so that  you
  131.  don't need to specify the corresponding command-line switches.
  132.  
  133.    - If you need to force a video mode, you can specify the mode here,  making
  134.      the "+" command line switch unnecessary. NOTE that you shouldn't force  a
  135.      video mode unless you NEED TO. CompuShow will detect the correct type  of
  136.      video adapter in virtually all cases.
  137.  
  138.    - Identify the type of of 480 line EGA you have ("/" switch.)
  139.  
  140.    - Bypass horizontal panning on an EGA display ("#E" switch.)
  141.  
  142.    - Enable PCjr/Tandy-1000 video modes ("#J" switch.)
  143.  
  144.    - The size of the read buffer ("#M" switch.)
  145.    - The amount of memory to reserve for the file directory ("#D" switch.)
  146.  
  147.    - The [F2] "log to drive and sub-directory".
  148.  
  149.    - The [F3] two column directory display mode.
  150.  
  151.    - The [F4] directory mask.
  152.  
  153.    - The [F5] directory sort options.
  154.  
  155.    - The "quiet" mode ("#Q" switch.)
  156.  
  157.  At the  last screen,  you may  "calibrate" the  delay routine  (on some  fast
  158.  computers, the delays may be significantly shorter than what you specify in a
  159.  Slide Show script.) Calibrating the  delay function calculates an  adjustment
  160.  factor, so that a one second delay actually lasts one second.
  161.  
  162.  When you finish the  System Configuration, your  specifications are saved  in
  163.  CSHOW.CFG, which CompuShow will look for it in the same sub-directory as  the
  164.  program.
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                                                         Page 3
  178. Printing
  179. ========
  180.  
  181.  CompuShow uses  custom  graphics printer  drivers  to support  a  variety  of
  182.  monochrome dot matrix, laser, and color printers.
  183.  
  184.  +---------------------------------------------------------------------------+
  185.  | FOR A COMPLETE, UP-TO-DATE LISTING OF THE PRINTER DRIVERS, SEE README.DOC |
  186.  +---------------------------------------------------------------------------+
  187.  
  188.  The information  in  README.DOC  should help  in  selecting  the  appropriate
  189.  printer driver as described above in the System Configuration program CSHOWI.
  190.  (If you're ONLY  selecting a  printer driver, you  can ESCape  out of  CSHOWI
  191.  after you've made your selection. You don't have to step all the way  through
  192.  the last screen.)
  193.  
  194.  Selecting a monochrome dot matrix driver:
  195.  
  196.   Most "IBM compatible"  printers (such  as Epson,  Citizen, Panasonic,  Star,
  197.   Toshiba, etc.) can use the IBM Graphics Printer driver.
  198.  
  199.   If your  printer has  a "quad-density",  240 dots/inch  mode, selected  with
  200.   ESCAPE,'Z', (eg. IBM Pro-Printer)  try the "generic" driver.
  201.  
  202.   If your printer  supports the "master  graphics" command ESCAPE,'*',n  where
  203.   the number n is 0 to 7, try the Citizen MSP 10/15/20/25 driver.
  204.  
  205.  - When CompuShow has loaded a printer driver:
  206.  
  207.     - The [Shift-F1] information box will include the printer driver name.
  208.  
  209.     - A "P to  print" reminder is  displayed on the  RLE and MacPaint  graphic
  210.       screens.
  211.  
  212.     - "P or ^P: print" is displayed in the graphic information box.
  213.  
  214.     - For most printer drivers, "^P=Non-Display print" is also listed near the
  215.       lower right corner of the graphic information box.
  216.  
  217.  - If no driver  is loaded, these  messages do not  appear, and attempting  to
  218.    print will sound a "buzzer".
  219.  
  220.  - In general,  a monochrome  printer  driver supports  two print  modes  when
  221.    available, and pressing ^P will provide  a faster print in a lower  density
  222.    mode, while pressing "P"  will provide a better  quality print in a  higher
  223.    density mode.
  224.  
  225.  - Similarly, "P"  and ^P  may produce  different quality  prints on  a  color
  226.    printer. In general, ^P is  intended for high-resolution graphics with  few
  227.    colors, while "P" is for lower-resolution graphics with more colors.
  228.  
  229.  - Beginning with  CompuShow version  8, improved  graphics print  quality  is
  230.    available with a monochrome printer capable  of at least 120 dpi (dots  per
  231.    inch). With one of these printer drivers, you'll see "^P=Non-Display print"
  232.    near the lower right corner of the graphics information box. To print  with
  233.    this improved quality,  follow the instructions  "FOR BEST PRINT  QUALITY",
  234.    below.
  235.  
  236.                                                                         Page 4
  237.  - Monochrome graphics (RLE  or MacPaint) are  printed by pressing  "P" or  ^P
  238.    while the graphic is displayed.
  239.  
  240.  - Color graphics are printed on a MONOCHROME PRINTER in one of three ways:
  241.  
  242.     - On any graphics adapter, display an image in a monochrome mode (A..O  or
  243.       P). This print is "WYSIWYG"  (What You See Is  What You Get), so  adjust
  244.       the "brightness" of the on-screen image with PgUp/PgDn before you  press
  245.       "P" or ^P to print.
  246.  
  247.     - FOR BEST PRINT QUALITY on an MCGA or VGA adapter, display the graphic in
  248.       an EGA, MCGA,  or VGA  mode (5..9),  convert to  gray-scale by  pressing
  249.       Alt-G and  adjust the  brightness  of the  image with  PgUp/PgDn  before
  250.       pressing "P" or  ^P to  print. (You may  print directly  from the  color
  251.       display,  although  you'll  probably  want  to  adjust  the   gray-scale
  252.       brightness before printing.)
  253.  
  254.         This method prints the screen contents. See "Cut and Paste", below.
  255.  
  256.     - FOR BEST PRINT QUALITY on any other (non-MCGA/VGA) adapter, press ^P for
  257.       non-display printing. The graphic will be decoded to the virtual  screen
  258.       as though you had a 256 color mode available. When the program is  ready
  259.       to print (you'll hear the "chirp", and  see a message), press "P" or  ^P
  260.       to print. If the print is too dark or light, use PgUp/PgDn to lighten or
  261.       darken it and press "P" or ^P to print again.
  262.  
  263.         This method can  accommodate images  up to 640x480  (depending on  the
  264.         amount of available  memory; use  Shift-F1 to  check the  size of  the
  265.         virtual screen.)  Printing while  viewing in  an "extended  VGA"  mode
  266.         ( [ ] , . / ), or from a video driver mode ( S..Y ) is similar to non-
  267.         display printing;  CompuShow will  print  the entire  image, up  to  a
  268.         maximum size of 640x480.
  269.  
  270.  - Color graphics are printed on a COLOR PRINTER in one of two ways:
  271.  
  272.     - Display the graphic  in a  256 color mode,  if available  (MCGA mode  8,
  273.       extended modes "[",  "]", etc.  or a video  driver mode  S..Y). You  may
  274.       adjust the brightness with PgUp/PgDn  and the color with [F1]..[F6],  as
  275.       needed. Press "P" or ^P to print.
  276.  
  277.     - If a 256 color mode isn't available, press ^P for non-display  printing,
  278.       and then "P" or  ^P when you  see the "ready to  print" message. If  the
  279.       print is too light or dark,  PgUp/PgDn (and [F1]..[F6]) will adjust  the
  280.       brightness and colors, as needed.
  281.  
  282.  - During printing, press any key to interrupt (and terminate) the print.
  283.  
  284.  - When the image has finished printing (or when it has been interrupted by  a
  285.    key-press) a form-feed will be sent to the printer. If your printer doesn't
  286.    advance to the top of the next page, you probably need to set  top-of-form.
  287.    If your printer doesn't have a specific button to set top of form, you  may
  288.    need to turn it off, re-position the paper, and turn it back on.
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                                                                         Page 5
  296. Cut and Paste:
  297. -------------
  298.  
  299.  A monochrome print made on an MCGA or VGA adapter in modes 5..9 is a print of
  300.  THE SCREEN CONTENTS, and a 320x200 display yields the highest quality  print.
  301.  An interesting result  is "Cut  and Paste"  capability. For  example, with  a
  302.  640x400x256 graphic:
  303.  
  304.   1. Display the 640x400x256 in  mode 8 (320x200x256),  go to gray-scale  with
  305.      Alt-G and adjust  the brightness,  as needed. Then  print the  upper-left
  306.      corner with "P" or ^P.
  307.  
  308.   2. Press Ctrl-Right to shift the display  one screen to the right and  print
  309.      the upper-right corner.
  310.  
  311.   3. Press Ctrl-Left (or  Home) to return  to the upper-left  corner and  then
  312.      Ctrl-End to move down one screen. Print the lower-left corner.
  313.  
  314.   4. Press Ctrl-Right (or End)  to shift to the  lower-right corner and  print
  315.      it.
  316.  
  317.  Pasting the  four quadrants  together produces  a gray-scale  print of  about
  318.  18x14". Of course larger 256 color images (such as 640x480 or 800x600) can be
  319.  printed on additional pages.
  320.  
  321. Custom Printer Drivers
  322. ----------------------
  323.  
  324.  Most modern  dot matrix  and  laser printers  are  supported by  the  printer
  325.  drivers included with the enhanced program. If, however, your printer doesn't
  326.  work with any of the supplied  drivers, see PRINTERS.DOC for the  information
  327.  we'll need to develop a custom driver for you.
  328.  
  329. CompuShow Slide Show
  330. ====================
  331.  
  332.  The slide  show can  be  run in  "dual monitor"  mode.  When started  on  the
  333.  monochrome monitor, the  slide show  "echoes" the  script file  lines to  the
  334.  monochrome monitor, while  displaying graphics images  on the color  graphics
  335.  monitor.
  336.  
  337.  Beginning with version 8.22,  the CompuShow Slide Show  is combined with  the
  338.  enhanced display program, rather than being  a separate program. When run  in
  339.  slide show mode, CompuShow reads the slide show instructions from a  "script"
  340.  file, "CSHOW.SCR", located on the current  disk and sub-directory. An "@"  on
  341.  the command line indicates  the start of  the script file  name. If you  have
  342.  several scripts, you can specify that a different script file should be used:
  343.  
  344.         >CShow @                        (script file "CSHOW.SCR")
  345.         >CShow @b                       (script file "b.SCR")
  346.         >CShow @b.                      (script file "b")
  347.         >CShow @.b                      (script file "CSHOW.b")
  348.         >CShow @b:                      (script file "b:CSHOW.SCR")
  349.         >CShow @b:b.b                   (script file "b:b.b")
  350.  
  351.  In other words, you can "over-ride" (any or all of) the location, file  name,
  352.  or extension.
  353.  
  354.                                                                         Page 6
  355.  The script  file is  an ASCII  (text) file,  which you  create using  a  word
  356.  processor or text editor  program. Word processor  programs usually have  the
  357.  ability to save in non-document, unformatted, or ASCII. (Be sure to do this!)
  358.  
  359. The Slide Show Script
  360. ---------------------
  361.  
  362.  Each slide show "command" is on a  separate line. The first character in  the
  363.  line specifies  the  type  of  command (UPPER  and  lower  case  letters  are
  364.  equivalent):
  365.  
  366.  F: The File name; the name of the  graphic file. You should include the  disk
  367.     drive and/or sub-directory name.
  368.  
  369.  M: The display mode:
  370.  
  371.       An "M" command alone tells CompuShow  to select the best available  mode
  372.       in the same way that the space bar works.
  373.  
  374.       To use a display mode other than the one the program selects as  "best",
  375.       the command should be "MC", "M8", "M]", "M3", "M," etc.
  376.  
  377.     In addition, you may display a "negated" RLE image by specifying mode "N",
  378.     and a colorized  MacPaint image  by specifying  modes "A"  through "J"  to
  379.     correspond to the ten color palettes selected with the [F1] through  [F10]
  380.     function keys.
  381.  
  382.  P: A pan.
  383.  
  384.       "P" alone will tell the program to perform a "right, down, left, up" pan
  385.       appropriate for the particular system it's running on.
  386.  
  387.       Otherwise, you may specifically pan  in a particular direction with  the
  388.       commands "PR",  "PD",  "PL",  and  "PU".  Using  specific  pan  commands
  389.       provides more complete control over the slide show, and lets you control
  390.       the length of delay after panning in a particular direction.
  391.  
  392.  D: A delay, in seconds, from 1 to  30. (Multiple "D" lines may be  specified,
  393.     if you want more than a 30 second delay.)
  394.  
  395.  W: Specifies a "Wait for key press". CShow will wait for a key to be  pressed
  396.     before proceeding.
  397.  
  398.  Q: Is the "Quit" command. CShow will quit, rather than repeating.
  399.  
  400.  For a  "free-running"  slide  show, you  would  use  "F", "M",  "P"  and  "D"
  401.  commands. The program will start over when it reaches the end of the  script.
  402.  You exit the program by pressing ESCape or Ctrl-C.
  403.  
  404.  By placing a "Q" command  at the end of the  script, the slide show will  run
  405.  one time and  then quit. (It  may be  interrupted with ESCape  or Ctrl-C,  if
  406.  desired.) By using wait (W) commands, instead of delay (D) commands, you  can
  407.  set up an "operator controlled" show, where the program waits for a key press
  408.  between images.  (Pressing  ESCape or  Ctrl-C  will  exit the  program  at  a
  409.  "Wait".)
  410.  
  411.  
  412.  
  413.                                                                         Page 7
  414. The Slide Show Script Program
  415. =============================
  416.  
  417.  SCRIPT.EXE is a program which will create a slide show script for you. It's a
  418.  DOS "pipe", which  takes its  input from  the output  of a  DIR command.  For
  419.  example:
  420.  
  421.         >dir *.gif | SCRIPT > allgifs.scr
  422.  
  423.  will create a script named "ALLGIFS.SCR".
  424.  
  425.  Keep in mind that you can "concatenate" the output of several DIR commands:
  426.  
  427.         >dir c:\pics\*.*      | sort  > full.dir
  428.         >dir c:\pics\more\*.* | sort >> full.dir
  429.         >SCRIPT < full.dir > full.scr
  430.  
  431.  (For more information on DOS "pipes", look under "Piping", "Redirection",  or
  432.  "Standard Input and Output", in your DOS manual.)
  433.  
  434.  SCRIPT will create a slide show script using "M" and "P" commands so that the
  435.  script is "portable" to any type of video system. Of course, once the  script
  436.  has been created, you can use a  word processor to rearrange the sequence  of
  437.  images, omit some of them, and enter specific display modes, etc.
  438.  
  439.  NOTE: If you're using "4DOS", you need to tell it to do its DIR display in  a
  440.  DOS compatible format (check the 4DOS documentation.)
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.                                                                         Page 8
  473.                                S H A R E W A R E
  474.                                =================
  475.  
  476.    CompuShow is copyrighted software. However, you are encouraged to copy  and
  477.  share it with others according to the following requirements:
  478.  
  479.       CompuShow may be freely copied and  shared with others, so long  as
  480.       no charge is made for the software, and it is unmodified and copied
  481.       in its  entirety,  including  all  program  documentation  and  all
  482.       support files.
  483.  
  484.       CompuShow may be distributed via modem, provided that all files are
  485.       transmitted (archived) together.
  486.  
  487.    Notice that ShareWare  is copyrighted  software. It's  not "Public  Domain"
  488.  software, nor is  it "free"  software. If you  continue to  use this  program
  489.  beyond a reasonable "trial period", not to  exceed 21 days, you must pay  for
  490.  it by registering.
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.   Thank you for your support:   Bob Berry
  509.                                 Canyon State Systems and Software
  510.                                 Post Office Box 86
  511.                                 Sedona, Az. 86336
  512.                                 Voice:      (602) 282-5070
  513.                                 CompuServe: [76555,167]
  514.                                 Internet:   76555.167@compuserve.com
  515.                                 GEnie:      R.BERRY7
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.            Graphics Interchange Format(c) copyright CompuServe Inc.
  527.              GIF(sm) is a Service Mark property of CompuServe Inc.
  528.  
  529.     Copyright (c) 1991, Canyon State Systems and Software (tm), Sedona, Az.
  530.  
  531.                                                                         Page 9
  532.